中文 | English

请将本页作为 Codex 配置文件的可检索参考来使用。如需概念性说明和示例，请先阅读 Config basics 与 Advanced Config。

config.toml

用户级配置位于 ~/.codex/config.toml。你也可以在 .codex/config.toml 文件中添加项目范围的覆盖项。只有在你信任该项目时，Codex 才会加载项目范围的配置文件。

对于沙箱与审批相关的键（approval_policy、sandbox_mode 和 sandbox_workspace_write.*），请将本参考与 Sandbox and approvals、Protected paths in writable roots 和 Network access 一起阅读。

你可以在 这里 找到最新的 config.toml JSON Schema。

如果你想在 VS Code 或 Cursor 中编辑 config.toml 时获得自动补全与诊断能力，可以安装 Even Better TOML 扩展，并在 config.toml 顶部加入这一行：

#:schema https://developers.openai.com/codex/config-schema.json

注意：请将 experimental_instructions_file 重命名为 model_instructions_file。Codex 已弃用旧键；请把现有配置更新为新名称。

requirements.toml

requirements.toml 是一种由管理员强制执行的配置文件，用于约束用户无法覆盖的安全敏感设置。有关详情、文件位置与示例，请参阅 Admin-enforced requirements。

对于 ChatGPT Business 和 Enterprise 用户，Codex 还可以应用从云端获取的 requirements。优先级细节请参阅安全文档。

在 requirements.toml 中使用 [features]，即可用与 config.toml 相同的规范键来固定 feature flags。未写出的键保持不受约束。